home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / mudfaq3 < prev    next >
Text File  |  1993-01-17  |  7KB  |  137 lines
  1. FREQUENTLY ASKED QUESTIONS: Basic Information on RWHO and "mudwho"
  2.  
  3. This is part 3 in a 3 part series of FAQs.
  4.  
  5. What Is RWHO?
  6. -------------
  7.  
  8.         RWHO stands for 'Remote WHO'.  It's a way of getting a WHO list
  9. from a MUD, without even having to connect to that MUD at all.  Anyone
  10. can get this output from a RWHO server (an 'mwhod'), by using straight
  11. telnet to connect to a certain port (6889), or by using the client program
  12. 'mudwho'.  RWHO servers talk to other mwhods, passing information around,
  13. and are talked to directly by some MUDs, receiving information from them. 
  14. Any one mwhod keeps track of several MUDs, plus storing information passed
  15. it from other mwhods.  Only MUDs that have the RWHO routines compiled in
  16. will be able to send their WHO list info to a mwhod.  UnterMUDs have this
  17. capability built in; other MUDs have to have the routines installed first.
  18. The RWHO routines have been installed into TinyMUSH, TinyMUCK, LPMUD,
  19. DikuMUD, and AberMUD, without encountering any difficulty.
  20.  
  21.  
  22. How Does It All Work?
  23. ---------------------
  24.  
  25.         'mwhod' is the RWHO server that runs on a particular host and
  26. keeps a list of known MUDs. It is initially primed with a list of "trusted"
  27. MUDs and passwords used for authentication, and will accept information
  28. about who is logged into those MUDs. The server also has a notion of
  29. a "peer" server, which can transfer it (occasionally) a copy of all of
  30. its list of who is logged on, and where. The idea is that the whole
  31. MUDding community could probably be served pretty well by about 5 peer
  32. mwhods that kept each other up to date about what each one is seeing.
  33.  
  34.         Communication between mwhods (and server updates sent to mwhods)
  35. is done with UDP datagrams, since they're fast, nonblocking, and
  36. throw-away. (RWHO information is considered to be interesting but not
  37. vital information, if you get my drift). Each MUD server only sends
  38. updates to a single mwhod, which may then propagate that information
  39. to its peers. This is done within the MUD server as follows:
  40.  
  41.         - whenever the server boots, it sends a "hi there" packet to
  42.          the mwhod, telling it that it's up and running.
  43.         - whenever a player connects, it sends a "so and so is here"
  44.          packet to the mwhod, telling it that the user has connected.
  45.         - whenever a player disconnects, it sends a "so and so left"
  46.          packet to the mwhod, telling it to delete the entry.
  47.         - every so often ("so often" being defined as a time agreed
  48.          upon by the mwhod's owner, and the MUD's wizard, usually
  49.          every 5 minutes or so) the MUD sends a "hi there" packet
  50.          and a complete list of everyone that is on, just to refresh
  51.          the mwhod's idea of who is logged into that MUD.
  52.  
  53.         If a user connects to a specific port (6889) of a host machine
  54. running an mwhod they are given a formatted dump of the mwhod's current
  55. table of MUDs and players, and then disconnected. "mudwho" is a simple
  56. little program that contacts an mwhod and downloads this information. 
  57. Ideally, the functionality of "mudwho" would be built into a player's
  58. client software, for ease of use. Two handy options can be used by 
  59. "mudwho", if the netlag to the mwhod server isn't too bad. The options
  60. are "-u <username>", and "-m <mudname>". If received before the timeout,
  61. the mwhod will then only dump WHO list information for the specified
  62. player or MUD.
  63.  
  64.         The mwhod does some clever stuff as far as eventually timing
  65. information about of its tables - for example, if it hears absolutely
  66. nothing from a MUD for a certain amount of time, it will mark the MUD
  67. as down. Player entries are expired similarly. The design is based on
  68. the idea that we'll use UDP to just fling information out and hope it
  69. sticks, and then let the recipient clean it up, rather than to develop
  70. a more complex protocol based on TCPs and timeouts. To prevent a packet
  71. circular send situation, each entry that is sent is given a "generation"
  72. number, which is incremented by one each time it is forwarded along. In
  73. this manner, a MUD server might send a "so and so is here" (generation
  74. zero) to its local mwhod. The local mwhod will eventually send a copy to
  75. any peers it may have (generation one), and so forth. Part of the initial
  76. table that an mwhod uses to establish what peers it trusts contains a
  77. generation value, and it will neither accept nor propagate information
  78. to a specific peer that is of a higher generation value. This way, a
  79. "tree" of servers could theoretically be constructed, with the highest
  80. level one having a total view of a large MudIverse.
  81.  
  82.  
  83. Where Can I Get This Stuff?
  84. ---------------------------
  85.  
  86.         The client program "mudwho" can be ftp'd from ftp.math.okstate.edu
  87. (139.78.10.6), in pub/muds/clients.  The shar file contains both
  88. mudwho.c and a README file, listing a few mwhod sites.  The plain "mudwho.c"
  89. file can be found at decuac.dec.com (192.5.214.1).
  90.  
  91.         The RWHO routines can be ftp'd from decuac.dec.com (192.5.214.1),
  92. in pub/mud.  Included is a HOW_TO file, which describes how to plug
  93. the routines into a MUD server, and also where to ask for a mwhod to use.
  94.  
  95.         The mwhod program itself can also be found on decuac, but there is
  96. currently little need for another one running in the USA.  There is, however,
  97. only one running in Europe, and further expansion may need to be made in
  98. that area. 
  99.  
  100.  
  101. Where Are Some RWHO Servers?
  102. ----------------------------
  103.  
  104. Currently, all of these servers talk to each other, so what one knows, 
  105. the rest will know, with the exception of the mwhod in Germany, which only
  106. talks to the mwhod on moebius.math.okstate.edu (so only moebius has
  107. the RWHO information from Europe currently). At any one time, there's an
  108. average of 20 muds, of various types, talking to mwhods.
  109.  
  110. Site                         IP           Port  Admin
  111. ------------------------------------------------------------------------------
  112. moebius.math.okstate.edu     139.78.10.3  6889  jds@math.okstate.edu
  113. amber.ecst.csuchico.edu      132.241.1.43 6889  warlock@ecst.csuchico.edu
  114. nova.tat.physik
  115.   .uni-nuebingen.de          134.2.62.161 6889  gamesmgr@taurus.tat.physik
  116.                                                 .uni-tuebingen.de
  117.  
  118. ------------------------------------------------------------------------------
  119.   This posting has been generated as a public service.  If you have any
  120.   suggestions, questions, additions, comments or criticisms concerning this
  121.   posting, contact Moira (jds@math.okstate.edu).  Other Frequently Asked
  122.   Questions (FAQ) postings contain information dealing with MUDs, MUDding,
  123.   clients, servers, and ftp sites.  While these items aren't necessary,
  124.   they make the game much more playable.  I'd also like to thank Marcus J.
  125.   Ranum (mjr@decuac.dec.com) for writing such a wonderful program (and
  126.   decent docs), and everyone else for helpful comments and suggestions. The
  127.   most recent versions of these FAQs are archived on ftp.math.okstate.edu
  128.   (139.78.10.6) in pub/muds/misc/mud-faq, plus on rtfm.mit.edu (18.172.1.27)
  129.   in the news.answers archives.  Have fun! - Moira
  130.  
  131. -- 
  132. Jennifer Smith
  133. jds@math.okstate.edu
  134. On MUDs: Moira, RosaLil, Jasra, etc.          |   It's the terror of knowing
  135. Here, have a clue. Take two, they're small.   |    What this world is about
  136.  
  137.